home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 05 Programming / SYMASS.BIN / SYMASS.DOC < prev    next >
Text File  |  2019-04-13  |  3KB  |  65 lines
  1. a tINY lITTLE sYMASS dOC fILE
  2.  
  3. iN MOST WAYS, THIS UNOFFICIAL VERSION OF sYMASS (LET'S CALL IT 3.9) IS JUST
  4. LIKE bRAD tEMPLETON'S (COMMERCIAL) ASSEMBLER pAL, SO IF YOU KNOW pAL, YOU'RE
  5. LAUGHING. iF YOU DON'T KNOW pAL, HERE'S A FEW THINGS YOU SHOULD KNOW, ALONG
  6. WITH SOME POINTS PARTICULAR TO sYMASS. iF YOU HAVE QUESTIONS, ADDRESS THEM
  7. TO kARL hILDON (76703,4242) OR nICK sULLIVAN (76703,4353) ON cOMPUsERVE'S
  8. cbmprg fORUM.
  9.  
  10. 1) uNLIKE pAL, sYMASS WAS WRITTEN BY rOBERT hUEHN, WITH ADDITIONAL FEATURES
  11. BY tIM bUIST. tHE PROGRAM IS COPYRIGHT BY tRANSACTOR pUBLISHING iNC., AND
  12. MAY BE FREELY REDISTRIBUTED BUT NOT SOLD COMMERCIALLY. iF YOU WANT TO INCLUDE
  13. IT IN YOUR USER GROUP LIBRARY, THAT'S OKAY, BUT YOU SHOULD REALLY WAIT FOR
  14. THE OFFICIAL VERSION 4.0 RELEASE, COMING SOON ON A tRANSACTOR DISK, WITH
  15. A FEW BUG FIXES AND SOME FURTHER ENHANCEMENTS.
  16.  
  17. 2) kNOWN BUGS IN THIS VERSION
  18.  
  19.   A) THE STACK IS NOT RESTORED PROPERLY AFTER ASSEMBLY. tHIS IS NOT A MAJOR
  20.   PROBLEM, BUT IF IT BOTHERS YOU, DO A clr IN DIRECT MODE TO CLEAN THE STACK.
  21.   
  22.   B) THE .BYTE AND .WORD PSEUDO-OPS WORK PROPERLY ONLY IF THERE ARE NO
  23.   EMBEDDED SPACES IN THE DATA. tHUS:
  24.   
  25.      .BYTE $57,$4F,$52,$4B,$53      ;WORKS
  26.      
  27.      .BYTE $46, $41, $49, $4C, $53  ;FAILS
  28.      
  29. 3) tO START THIS VERSION OF sYMASS, LOAD "BOOT",8 AND RUN. tHE ASSEMBLER
  30. MUST BE ON THE DISK IN DEVICE 8, DRIVE 0, UNDER THE NAME sYMASS3.9. iT LOADS
  31. UNDER THE bASIC rom AT $a000, CONSUMING ABOUT 5k. a SHORT INTERFACE ROUTINE
  32. IS LOCATED AT ADDRESS 700, WHERE IT IS PUT BY THE BOOT PROGRAM.
  33.  
  34. 4) wRITE YOUR SOURCE AS A bASIC PROGRAM FILE WITH sys 700 AT THE START OF
  35. YOUR 6502 CODE, AND .end AT THE END. sPECIFY THE START ADDRESS WITH A LINE
  36. LIKE:
  37.  
  38.      110 *= $C000
  39.      
  40. 5) tHE .opt PSEUDO-OP SPECIFIES OUTPUT OPTIONS. tHE MAIN ONE IS .opt oo,
  41. WHICH MEANS TO ASSEMBLE TO MEMORY AT THE SPECIFIED ADDRESS. yOU CAN ALSO
  42. SPECIFY ASSEMBLY TO DISK WITH .opt #, WHERE # IS A LOGICAL FILE YOU OPENED
  43. IN A LINE BEFORE THE sys 700, LIKE THIS:
  44.  
  45.      100 open 2,8,2,"0:mutant feet,p,w"
  46.      110 sys 700
  47.      120 .opt o2
  48.      130 *= $1000
  49.      
  50. sYMASS CLOSES THE FILE FOR YOU AFTER ASSEMBLY - YOU DON'T HAVE TO DO IT
  51. YOURSELF.
  52.      
  53. 6) sET UP EQUATES USING THE EQUALS SIGN, NOT equ OR WHATEVER. lIKE THIS:
  54.  
  55.      150 chrout = $ffd2
  56.      160 skidoo = $23
  57.      
  58. 7) mANY OF pAL'S MORE ROCOCO FEATURES ARE NOT SUPPORTED BY sYMASS, E.G.
  59. THE RELOCATING OBJECT OPTION, THE .bas AND .file PSEUDO-OPS AND DIVISION IN
  60. EXPRESSIONS. aT LEAST .file WILL PROBABLY BE ADDED FOR THE NEXT VERSION.
  61.  
  62.  
  63. nICK sULLIVAN
  64. tRANSACTOR
  65.